home *** CD-ROM | disk | FTP | other *** search
/ Nautilus 1992 July / Nautilus-3-8 / Nautilus-3-8.bin / Tools & Utilities / Techy Stuff / Frontier Scripts / Sharing Scripts & Suites < prev    next >
Encoding:
Text File  |  1992-06-12  |  4.5 KB  |  83 lines
  1.  
  2. Sharing Scripts & Suites
  3. ------------------------
  4.  
  5. You╒ve developed the coolest desktop script or suite of scripts and want to
  6. share it with the world. How to proceed?
  7.  
  8. 1. First, think about your user and other script developers who might use and
  9. read your scripts. Ask someone else to look at your work and use it before you
  10. upload. Or play the role of ╘dumb user╒ yourself. When people import your work
  11. into their object database they want to have fun -- they don╒t want to
  12. struggle.
  13.  
  14. 2. Keep a ╥virgin╙ copy of the Frontier folder on your hard disk. Import your
  15. script or suite into that virgin copy. Are there any problems? If so, try
  16. again.
  17.  
  18. 3. Use the right Export method. If it╒s a desktop script, use the Export a
  19. Desktop Script command in the UserLand/Export sub-menu. If it╒s anything else,
  20. use the Export an Object command. This is very, very important. If you use the
  21. wrong export format, people who double-click on the icon will likely get an
  22. error from Frontier. They will certainly get surprising results.
  23.  
  24. 4. If it╒s a desktop script, before you export it, copy and paste it into the
  25. system.deskscripts table and export from there. This makes running and
  26. importing the script a snap because Frontier.root ships with a
  27. system.deskscripts table. All the UserLand-supplied desktop scripts ╥live╙ in
  28. the system.deskscripts table. Unless there╒s a really good reason to export a
  29. desktop script from another location, please use the system.deskscripts table.
  30.  
  31. 5. Lean towards using suites. Unless you╒re providing a simple, self-contained
  32. desktop script, develop and export your stuff from a sub-table in the suites
  33. table. That will give you enough room to add all the readme text that your
  34. users will need. And you can organize your code intelligently and provide lots
  35. of comments and annotations. Follow the examples of the UserLand-supplied To Do
  36. List suite, or the Network Utilities suite.
  37.  
  38. 6. If it╒s not a desktop script and it╒s not big enough to be a suite, export
  39. it from one of two places: the scratchpad table or your people table. When the
  40. receiver imports the object, a dialog prompts for a location to import it to.
  41. At this point, your user can change your location to one that makes more sense
  42. to him or her. It╒s important that you test such scripts in different locations
  43. to be sure that they will work no matter where they were loaded into the object
  44. database. Or, if they must be run from a fixed location, you should tell the
  45. user about your rules in some readme text.
  46.  
  47. 7. Provide instructions. In the Network Utilities suite, we open a readme
  48. wptext window when the suite is imported. Your users will want brief,
  49. to-the-point information about your scripts. It╒s OK to sell and be
  50. enthusiastic. But be factual and explain the who, what, why, when, where and
  51. how of the functionality you are providing. If you╒re providing a desktop
  52. script, you can use a wptext object, or (as we do) assume that the user has
  53. Apple╒s TeachText utility.
  54.  
  55. 8. Confirm before you install any agents. If your suite installs a script in
  56. the system.agents table (as the Network Utilities and To Do List suites do),
  57. confirm that this is OK with your user. Installing an agent is like installing
  58. an INIT in the System Folder. They may just be importing your suite to see if
  59. they want to use it. Don╒t make any assumptions.
  60.  
  61. 9. Where to upload. Once you╒re satisfied that the world is ready for your
  62. scripts (and your scripts are ready for the world!) upload them to the UserLand
  63. Forum on CompuServe or the UserLand Discussion Board on AppleLink. On
  64. CompuServe, we╒ve reserved a special library, DL2, for new scripts and suites.
  65. On AppleLink, upload your scripts to the ╥Shared Scripts╙ folder in the
  66. Discussion Board. See the ╥UserLand On-Line╙ TeachText file for information
  67. about our on-line services.
  68.  
  69. 10. Shareware is OK. Feel free to use our on-line services to distribute
  70. shareware implemented as a Frontier suite or set of desktop scripts. Just be
  71. sure it╒s clearly labeled as shareware in the description, and don╒t ask for
  72. money if you╒re just providing a 20-line script that only works on your
  73. machine. We╒re not sure what kind of market will develop for Frontier scripts,
  74. or if a market will develop. Stay tuned!
  75.  
  76. Summary: It takes a special attitude to be a software developer. Frontier can
  77. make it easier to produce useful functionality for others, but you still have
  78. to test and document, and even sell your work so that others can enjoy the
  79. fruits of your labor. We╒re glad to help where we can, we have a strong
  80. interest in your success. Let us know if we can help!
  81.  
  82. Author: EL.GRANDE
  83.